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HI Subpackages 
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class tcs.ain. infoserver.DataTransiationFilter 
class tcs.ain.infoserver.DataWorker 
class tcs.ain.infoserver.DatabaseDestination 
class tcs.ain.infoserver.DatabaseDestinationException 
class tcs.ain.infoserver.ElementNotFoundException 
class tcs.ain Jnfoserver.EmailUserDestination 
class tcs.ain.infoserver.EmailUserDestinationException 
class tcs.ain.infoserver. I nfoServer 
class tcs.ain.infoserver. InfoServerElement 
class tcs.ain.infoserver. I nfoServerEvent 
class tcs.ain. infoserver.lnfoServerException 
class tcs.ain. infoserver. JDBCQueryEngine 
class tcs.ain.infoserver JDBCQueryEngine.XMLInputStream 
class tcs.ain. infoserver.NewEmailQEException 
class tcs.ain. infoserver.NewEmailQueryEngine 
class tcs.ainJnfoserver.NewEmailQueryEngine.XMLInputStream 
class tcs.ain. infoserver. NotifyChangeOnlyDestination 
class tcs.ain. infoserver.PageParserQEException 
class tcs.ain. infoserver.PageParserQueryEngine 
class tcs.ain. infoserver.PageParserQueryEngine.XMLInputStream 
class tcs.ain. infoserver.QNConst 
class tcs.ain Jnfoserver.QNServerResource 
class tcs.ain. infoserver.QNWebPagePrinter 
class tcs.ain. infoserver. serviet.QNWebPagePrinter 
class tcs.ain. infoserver. QueryEngine 
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class tcs.ain.infoserver.QueryNetResource 
class tcs.ain.infoserver.Repository 
class tcs.ain.infoserver.SMSUserDestination 
class tcs.ain.infoserver.SMSUserDestinattonException 
class tcs.ain.infoserver.SearchFilter 
class tcs.ain.infoserver.SearchFilter.XMLInputStream 
class tcs.ain.infoserver.SimpleUserDestination 
class tcs.ain.infoserver.TimeEIement 
class tcs.ain.infoserver.Timer 
class tcs.ain.infoserver.UserAgent 
class tcs.ain.infoserver.UserDefiveryDestination 
class tcs.ain.infoserver.WebQueryEngine 
class tcs.ainJnfoserver.Worker 
class tcs.ain.infoserver.access.lnfoServerAccess 
class tcs.ain.infoserver.access.infoServerAccess_Skel 
class tcs.ain.infoserver.access.lnfoServerAccess_Stub 
class tcs.ainJnfoserver.pqaXCDemoPublicDS 
class tcs.ain.infoserver.pqa.PQAEBook 
class tcs.ain.infoserver.pqa.PQALauncher 
class tcs.ain.infoserver.pqa.PQALogin 
class tcs.ain.infoserver.pqa.PQAMenu 
class tcs.ain.infoserver.pqa.PQAPage 
class tcs.ain.infoserver.pqa.PQAPagePrinter 
class tcs.ainJnfoserver.pqa.PQAServletMain 
class tcs.ain.infoserver.pqa.QNetPQAResource 
class tcs.ain.infoserver.servlet.AddEditServicesPage 
class tcs.ain.infoserver.servlet.CreateNewSourceForm 
class tcs.ain.tnfoserver.servlet.CustomSourceForm 
0 class tcs.ain.infoserver.servlet.CustomizeAgentForm 

class tcs.ain.infoserver.servlet.DataSourceForm 
tT| class tcs.ain.infoserver.servlet.DataWorkerForm 
J! class tcs.ain.infoserver.servlet.DataWorkerWizardForm 
W class tcs.ain.infoserver.servlet.DestinationForm 
yTi class tcs.ain.infoserver.servlet.lSEIementCreatorException 
21 class tcs.ainJnfoserver.servlet.lSEIementLoader 
7l class tcs.ain.infoserver.servletJSServletException 

class tcs.ain.infoserver.servlet.lnfoSvrMain 
Ql class tcs.ain.infoserver.servletlnfoSvrPage 
„ ' class tcs.ain.infoserver.servlet.LoginPage 

class tcs.ain.infoserver.servlet.MainMenuPage 
M class tcs.ain.infoserver.servlet.PubiicSourceForm 
f!J class tcs.ain.infoserver.servlet.QNServiceCreator 
fit class tcs.ain.infoserver.servlet.QNServletResource 
lit class tcs.ain.infoserver.servlet.QNWebPagePrinter 
fel class tcs.ain.infoserver.serviet.QueryNetResource 
CJ class tcs.ainJnfoserver.servletStatusForm 

class tcs.ain.infoserver.servlet.ViewServicesPage 
" class tcs.ain.infoserver.simpleweb.CustomEmaiiSourceGenerator 
class tcs.ainJnfoserver.simpleweb.CustomWebSourceFormGenerator 
class tcs.ain.infoserver.simpleweb.CustonnWebSourceGenerator 
class tcs.ain.infoserver.simplewebJnvalidParameterException 
class tcs.ain.infoserver.simptewebJspBean 
class tcs.ain.infoserver.simpieweb.PublicAgentListGenerator 
class tcs.ain.infoserver.simpleweb.UserWorkFormGenerator 
class tcs.ain.infoserver.simpieweb.UserWorkFormProcessor 
class tcs.ain.infoserver.simpleweb.CustomWebSourceFormGenerator 
class tcs.ain.infoserver.simpleweb.JspBean 
class tcs.ain.infoserver.simpleweb.PublicAgentListGenerator 
class tcs.ain.infoserver.simpleweb.UserWorkFormGenerator 
class tcs.ain.infoserversimpleweb.UserWorkFormProcessor 
class tcs.ain.infoserver.tests.GSWDS 
class tcs.ain.infoserver.tests.Testl 
class tcs.ain.infoserver.tests.Testl 1 
class tcs.ain.infoserver. tests. Testl2 
class tcs.ain.infoserver.tests.Test2 
class tcs.ain.infoserver.tests.Test3 
class tcs.ain.infoserver.tests.Test4 
class tcs.ain.infoserver.tests.TestlO 
class tcs.ain.infoserver.tests. Tests 
class tcs.ain.infoserver. tests. Test6 
class tcs.ain.infoserver.tests.Test7 
class tcs.ain.infoserver. tests. Test8 
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class tcs.ain.infoserver.tests.Test9 

class tcs.ainJnfoserver.tests.TestPageParserQE 

class tcs.ain.infoserver.tests.WLabDS 

class tcs.ain.infoserver.simpleweb.CustomWebSourceFormGenerator 
class tcs.ain.infoserver.simpleweb.JspBean 
class tcs.ain.infoserver.simpleweb.PubiicAgentListGenerator 
class tcs.ain.infoserver.simpieweb.UserWorkFormGenerator 
class tcs.ain.infoserver.simpIeweb.UserWorkFormProcessor 

O Interfaces 

interface tcs.ainJnfoserver.lDataEventListener 
interface tcs.ain.infoserver.lDataEventSource 
interface tcs.ain.infoserver.lDataSource 
interface tcs.ain.infoserver.access.lRemoteRepository 
interface tcs.ain.infoserver.pqa.PQAConst 
interface tcs.ain.infoserver.serviet.lSEIementCreator 




Class Diagram access 



j ava . rmi . Reraot 
interface 
IRemo teReposXtory 



-his Connected: boolean 
+ get User Agent: User Agent 
■haddUser Agent : void 
-hgetQuery Engines : Hashtable 
+getQueryEngine : QueryEngine 
+getWorkerIdsFromAgent : Vector 
+launchWorker: String 
-hlaunchWorker: String 



UnicastRemoteObj ec 
Info Server Access „__ 



#repository: Repository 



+isConnected: boolean 
+InfoServerAccess 
+getUserAgent : UserAgent 
+addUser Agent : void 
+getQueryEngines : Hashtable 
+getQueryEngine : QueryEngine 
-1-getWorkerIdsFromAgent :Vect 
+launchWorker: String 
+launchWorker: String 



connected : boolean 
queryEngines : Hashtable 



j ava. lang. Ob j 
j ava . rmi . server . Skel 
InfoServerAccess Skel 



-operations : i ava . rmi . server . 
-interf aceHash: long 



+InfoServerAccess_Skel 
+dispatch : void 



operations : j ava . rmi . server . 



j ava. rmi. server. RemoteS 
j ava . rmi . Remot 
InfoServerAccess Stub 



-operations : i ava . rmi . server . 
-interf aceHash : long 



+Inf oServerAccess_Stub 
+InfoServerAccess_Stub 
+addUserAgent : void 
+getQueryEngine : tcs . ain . info 
+getUserAgent : tcs . ain. inf ose 
+getWorkerIdsFromAgent : j ava . 
+launchWorker : j ava . lang . Stri 
+launchWorker : j ava . lang . Stri 



queryEngines : j ava . util . Hash 
connected: boolean 
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Class Nodes 

tcs.ain. inf oserver.access.infoServerAccess 
tcs.ain. inf oserver.access. 1 nf oServerAccess_Skei 
tcs.ain.infoserver.access.lnfoServerAccess_Stub 

Interface Nodes 

tcs.ain .inf oserver.access. t RemoteRepository 



Q Class tcs.ain. infoserver.access.lnfoServerAccess 

This class provides access to user agents within the Info Server. May be replaced by a Jini Service in the near future. This provides 
access to the assigned Repository 

Extends: 

UnicastRemoteObject 

Implements: 

I RemoteRepository 



to Interface i RemoteRepository 

yijfi Class tcs.ain. infoserver.access.lnfoServerAccess_Skel 

$v'i Extends: 
ifi java.lang.Object 

Implements: 

id java.rmi.server.Skeleton 

* B Class tcs.ain. infoserver.access.InfoServerAccess Stub 

fy Extends: 

f|| java.rmi.server.RemoteStub 

III Implements: 

Q tcs.ai n. inf oserver.access. I RemoteRepository 
iSi. java.rmi. Remote 

to Interface i RemoteRepository 
Interface Node Detail 

Q Interface tcs.ain.infoserver.access.lRemoteRepository 

This interface provides access to user agents within the Info Server. May be replaced by a Jini Service in the near future. 

Extends: 

java.rmi. Remote 



Class Diagram dest 



CI 
si 

m 
m 
si 

w 



Class Diagram infoserver 



P 

W 
III 
CI 
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Package Nodes 

tcs.ain. infoserver.access 
tcs.ain. infoserver.dest 
tcs.ain. infoserver.pqa 
tcs.ain.infoserver.servlet 
tcs.ain.infoserver.simpleweb 
tcs.ain. infoserver.source 
tcs.ain. infoserver.tests 

Class Nodes 

tcs.ain.infoserver.CalendarTimer 
tcs.ain.infoserver.ChangeOnlyFiiter 
tcs.ain. infoseiw.ChatliserDestination 
tcs.ain. infoserver.ChatUserDestination Exception 
tcs.ain. infoserver.ConditionFHter 
tcs.ain.infoserver.DatabaseDestination 
tcs.ain. infoserver.DatabaseDestinationException 
tcs.ain.infoserver.DataEvent 
tcs.ain. infoserver.DataFilter 
tcs.ain. infoserver.DataFormatter 
tcs.ain.infoserver.DataSourceTextDataFormatter 
tcs.ain. infoserver.DataSourceXSLDataFormatter 
tcs.ain.infoserver.DataTranslation Filter 
tcs.ain . inf oserver. DataWorker 
tcs.ain. infoserver.ElementNotFoundException 
tcs.ain.infoserver.EmailUserDestination 
tcs.ain. inf oserver. EmailUserDestination Exception 
f | tcs . ai n . i nf oserver. I nf oServer 
™l tcs.ain.infoserver.infoServerElement 
^ tcs.ain. inf oserver. InfoServerEvent 
SI tcs.ain.infoserver.infoServerException 
f|! tcs.ain.infoserver.JDBCQueryEngine 
lis tcs.ain. infoserver.NewEmailQEException 
h t} tcs.ain. inf oserver. NewEmaiiQueryEngine 
4* tcs.ain.infoserver.NotifyChangeOnlyDestination 
hi tcs.ain. infoserver.PageParserQEException 
tcs.ain. infoserver.PageParserQueryEngine 
m tcs. a i n . i nf oserver. Q N Con st 
£ tcs.ain.infoserver.QNServerResource 
C! tcs.ain.infoserver.QNWebPagePrinter 
lis tcs.ain. infoserver.QueryEngine 

tcs.ain.infoserver.QueryNetResource 
W tcs.ain.infoserver.Repository 
f!!| tcs.ain. infoserver. Sea rchFi iter 
Jh tcs.ain. i nf oserver.serviet.QNWebPagePrinter 

tcs.ain. infoserver. Si mpieUserDesti nation 
H tcs.ain. infoserver.SMSUserDesti nation 

tcs.ain. infoserver.SMSUserDestinationException 

tcs.ain. infoserver.TimeElement 

tcs. a in. inf oserver. Timer 

tcs.ain. i nf oserver. UserAgent 

tcs.ain. inf oserver. UserDeiiveryDestination 

tcs.ain. infoserver.WebQueryEngine 

tcs.ain.infoserver.Worker 

Interface Nodes 

tcs.ain. infoserver. I DataEventListener 
tcs.ain.infoserver.lDataEventSource 
tcs.ain. infoserver.iDataSource 
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Package tcs.ain.infoserver.access 



Package tcs.ain.infoserver.dest 



Package tcs.ain.infoserver.pqa 
Package tcs.ain.infoserver.servlet 



Package tcs.ain.infoserver.simpleweb 



Package tcs.ain.infoserver.source 



Package tcs.ain.infoserver.tests 



Class tcs.ain.infoserver. CalendarTimer 

This Timer wiil tell the worker to doWork whenever the assigned time criteria have been met. Similar to a cron job r it receives minutes, 
hours days of week, and days of month values that define when the work should be performed. Currently this just checks its 
TimeElements every 60 sees to see if it should fire. Perhaps later we can sleep the maximum amount possible given the assigned values. 




to Class Timer 



to Class TimeElement 
to Class TimeElement 
to Class TimeElement 
to Class TimeElement 



I Class tcs.ain.infoserver.ChangeOnlyFilter 

Just send the output to STDOUT. 

Extends: 

DataFilter 

to Class DataFilter 
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Class tcs.ain.infoserver. ChatUserDestination 

Send the output to a user's email account. SMTP-relevant info must first be defined for the class. 

Extends: 

UserDeliveryDestination 

to Class UserDeliveryDestination 

Class tcs.ain.infoserver. ChatUserDestinationException 

Extends: 

infoServerException 

to Class InfoServerException 

Class tcs.ain.infoserver.ConditionFilter 

Extends: 

java.lang.Object 

Implements: 

tcs. a i n . inf oserver. i DataEventLi stener 
tcs.ain.infoserver. I DataEventSource 

to Interface IDataEventListener 
to Interface 1 DataEventSource 

I Class tcs.ain.infoserver.DatabaseDestination 

This performs SQL statements that must be embedded within the received XML data. This assumes that an XSLTemplate assigned to its 
(DataFormatter)DataSourceXSLDataFormatterwill provide XML data in the following format: 

<STATEMENTS><SQL>xxxxx</SQLx/STATEMENT> It will then execute each statement against the schema assigned to it. 

Extends: 

UserDeliveryDestination 

to Class UserDeliveryDestination 

3 Class tcs.ain.infoserver.DatabaseDestinationException 

Extends: 

InfoServerException 



to Class InfoServerException 



Class tcs. am. inf oserver. Data Event 

Event fired to a DataDestination whenever new data is available This provides a reference to the Data Source containing the new data, it 
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is up to the receiver to get the data if it wants it. 

Extends: 

InfoServerEvent 



to Class InfoServerEvent 

to Interface IDataSource 

Documentation: 

This is the object containing the new/updated data 

H Class tcs.ain.infosen/er.DataFilter 
Just send the output to STDOUT. 

Extends: 

InfoServerElement 

Implements: 

IDataEventListener 
fl IDataEventSource 
IDataSource 

U| to Class InfoServerEiement 

w " to Interface IDataEventListener 
to Interface IDataEventSource 
to Interface IDataSource 



to Interface IDataEventListener 

associates: 

IDataEventListener 

to Class DataFormatter 

Documentation: 

Default Data Formatter 

I Class tcs.ain.infoserver.DataFormatter 

Default implementation just returns the XML data retrieved directly from the data set. 

Implements: 

Serializable 
TCSPersistent 

I Class tcs.ain.infoserver.DataSourceTextDataFormatter 

This class returns a format using an XSL Document provided by the data source. The data source can offer multiple styles, each of which 
is queried by name. This is assigned the name to be used for retrieving the XSL doc from the data source. 
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Extends: 

Data Formatter 

Implements: 

TCSPersistent 

to Class DataFormatter 

Class tcs.ain.infoserver.DataSourceXSLDataFormatter 

This ciass returns a format using an XSL Document provided by the data source. The data source can offer multiple styles, each of which 
is queried by name. This is assigned the name to be used for retrieving the XSL doc from the data source. 

Extends: 

DataFormatter 

to Class DataFormatter 

Class tcs.ain.infoserver. DataTranslationFilter 

This class receives DataEvents, queries the original datasource and assembles its Own Data. It then generates a new DataEvent to its 
listeners telling them to query it's own data. 

Implements: 

IDataEventListener 

IDataEventSource 

IDataSource 

to Interface IDataEventListener 
to Interface IDataEventSource 
to Interface IDataSource 

1 Class tcs.ain.infoserver. DataWorker 
A DataWorker tells a DataDestination that it ought to query a Datasource. 

Extends: 

Worker 

Implements: 

IDataEventSource 

to Class Worker 

to Interface IDataEventSource 

to Interface IDataSource 
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associates: 
IDataSource 

to Interface IDataEventListener 

associates: 
IDataEventListener 



Class tcs.ain.infoserver.ElementNotFoundException 

Extends: 

InfoServerException 



to Class InfoServerException 
Class tcs.ain.infoserver.EmailUserDestination 

Send the output to a user's email account SMTP-relevant info must first be defined for the class. 

Extends: 

UserDeliveryDestination 

to Class UserDeliveryDestination 
Class tcs.ainjnfoserver.EmailUserDestinationException 

Extends: 

1 nf oServerException 

to Class InfoServerException 

I Class tcs.ain.infoserver.lnfoServer 
Version information 1.0.0 

Extends: 

Thread 



to Class Repository 



Class tcs.ain.infoserver.lnfoServerElement 

Base class for all infoServer elements. Provides mechanism for grouping, ensures all elements are serializable, provides common 
description functions, etc. 

Implements: 

Serializable 
TCSPersistent 
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Class tcs.ain.infoserver.lnfoServerEvent 

Top level event type for events with the Info Server, 

Extends: 

java.util.EventObject 

Class tcs.ain.infoserver. InfoServerException 

Extends: 

Exception 

Class tcs.ain.infoserver JDBCQueryEngine 

A QueryEngine that accesses a JDBC data source. This model copies the ENTIRE data into memory. Other implementations can stream 
if necessary. This also assumes a SINGLE database query is performed (although that query can be reassigned). 

Extends: 

QueryEngine 

to Class OuervEngine 



Class tcs.ain.infoserver.NewEmailQEException 



Extends: 

InfoServerException 



to Class InfoServerException 



Class tcs.ain.infoserver.NewEmaiiQueryEngine 

This class publishes new Email messages that appear in a mailbox for a user at an IMAP address. This Email information must be 
provided in the constructor of the class and/or via accessors. It is also possible to this class also act like a data worker. If could register 
as a Folder Listener and immediately fire events whenever this is notified of new mail. Unfortunately, this would create a lock on the 
InBox and potentially tie up network resources. This just acts like a listener and only requeries whne asked, provided that the 
minQuerylnterval has not been exceeded. It opens an IMAP connection as READONLY, checks for NEW messages, and closes when done. 
Because of the potential size of this data, the final implementation should not be cached, but rather stream directly from the IMAP 
source to the XML Reader !!!!!YOU MUST SUPPLY THE host, accountUser, mailBox, AND password VARIABLES BEFORE USEING!!!!!!!!!! 

Extends: 

QueryEngine 

to Class OuervEngine 



! Class tcs.ain.infoserver.NotifyChangeOnlyDestination 
Extends: 

tcs.ain.infoserver. UserDeliveryDestination 
to Class UserDeliveryDestination 
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Class tcs.ain. infoserver. PageParserQEException 

Extends: 

I nf oServerException 

to Class I nf oServerException 
Class tcs.ain. infoserver. PageParserQueryEngine 

This query engine uses the TCS page parser to examine an html/xml document. The page parser provides access to the components of a 
page according to the underlying document structure. This engine allows the user to specify the portions of the page that are to be 
retrieved. Document structure is according to common HTML tag elements if no targetElements are defined, then all are returned 

Extends: 

QueryEngine 

to Class QueryEngine 

Class tcs.ain. infoserver.QNConst 

Class tcs.ain. infoserver.QNServerResource 

This class is a singleton for a property resource bundle to be used by the Query Net Wizard. The resource bundle contains values that 
could potentially displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
MIssingResourceExceptions ras; 2/29/99; modified by S. Levine on 9/9/99 

Class tcs.ain. infoserver. QNWebPagePrinter 

Extends: 

tcs.web.WebPagePrinter 

Class tcs.ain. infoserver. QueryEngine 

Queries external sources for information which can be made available to DataDestination object. As required, this provides its data as an 
XML stream. 

Extends: 

InfoServerElement 

implements: 

IDataSource 

to Class InfoServerElement 

to Interface IDataSource 

to Class DataFormatter 
Documentation: 

The default dataformatter to be used. This will be used in a launch on demand (i.e. "MO") situation where want to retrieve data 
directly from the Datasource. 
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Class tcs.ain.infoserver. Query NetResource 

This class is a singleton for a property resource bundle to be used by the Qu 
could potentially displayed to users. It also provides a direct, static method 
MIssingResourceExceptions ras; 2/29/99; modified by S. Levine on 9/9/99 



Class tcs. ain. infoserver. Repository 



and retrieving UserAgents and QueryEngines. Alt of the elements owned by a UserAgent will be saved along 



Class tcs.ain.infoserver.SearchFilter 

Extends: 

Data Filter 

Implements: 

SimpleSaxHandler 

to Class Data Filter 
I Class tcs.ainMoserver.servlet.QNWebPagePrinter 

Base class for web page printing operations. Provides methods to print the header, banner, etc. Subclasses can provide 
font / banner schemes for individual projects or pages 

Extends: 

WebPagePrinter 

I Class tcs.ainJnfoserver.SimpleUserDestination 

Just send the output to STDOUT. 

Extends: 

UserDeliveryDestination 



to Class UserDeliveryDestination 

Class tcs.ain.infoserver.SMSUserDestination 
This sends its data via RMi to the Web Gateway's queue 

Extends: 

UserDeliveryDestination 






to Class UserDeliveryDestination 



Class tcs.ain.infoserver.SMSUserDestinationException 



Extends: 

InfoServerException 




to Class InfoServerException 
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Class tcs.ain.infoserver. TimeElement 

This provides services for identifying time elements used by the CaiendarTimer. Can represent minutes, hours, day of week, etc. 

Implements: 

Serializable 
TCSPersistent 

Class tcs.ain.infoserver .Timer 

Used by Worker to control when the worker should do its work. Different types of timers can fire according to time elapsed, # of events, 
time of day, etc. This timer just fires once at start. 

Extends: 

Thread 

Implements: 

Serializable 
TCSPersistent 

to Class Worker 

Class tcs.ain.infoserver.UserAgent 

UserUser is a collection of information about the User. It also collects all of the InfoServerElements desgnated to this user. The user's 
workers, dataDestinations, private dataSources, etc. are contained by this user. 

Extends: 

infoServerElement 



to Class InfoServerElement 
I Class tcs.ain.infoserver.UserDeliveryDestination 

This implementation uses a DataFormatter for retrieving the info from the DataSource and returning a String representation. Subclasses 
of this will implement the deliverData() method, which will take the string representation of the data and send it to the end-user in an 
appropriate manner. 

Extends: 

InfoServerElement 

Implements: 

IDataEventListener 

Hi 

to Class InfoServerElement 

lillliH 

to Interface IDataEventListener 

to Interface IDataEventListener 

associates: 

IDataEventListener 



to Class DataFormatter 



Documentation: 

Default Data Formatter 
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H Class tcs.ain.infoserver.WebQueryEngine 

This handles querying a web page Internally uses a JDNC driver which reads HTML. 

Extends: 

JDBCQueryEngine 

to Class JDBCQueryEngine 

B Class tcs.ain.infoserver.Worker 

Worker has its own thread and actually initiated actions within the InfoServer environment. Workers are typically defined by/for 
UserAgents and initiatiate interaction between other InfoServerElements. Base class handles default details of when the worker should do 
its work by using the Timer class. Timer is a special thread that is used to determine when the Worker should do its work. Subclasses 
must provide the doWork() method, which is called whenever the thread executes. 

Extends: 

InfoServerElement 

s. Implements: 

TCSPersistent 

to Class InfoServerElement 



to Class Timer 

Documentation: 

The timer that drives when the worker does work. 



■Interface Node Detail 

Interface tcs.ainJnfoserver. IDataEventListener 



Extends: 

java . uti i . EventListener 



O interface tcs.ain.infoserver.lDataEventSource 

O Interface tcs.ain.infoserver.lDataSource 

This interface defines what to expect from an information supplier Ideally a data source will provide: - some data - a definition of the 
data (DTD) - some ways to display the data The last is optional. The DTD is a good idea, but is not yet enforced. 



Class Diagram MoreDetailed 
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interface 
XDataSoaircm 

gatXMLStresm 
getDTD 

getXSLVocCoant 
getXSIName 
gs tXSLDoc urns tl t 



interface 
ID*tagvntSourc« 

a ddDa t&EventLi s tener 
retoo veDd t aEven tZ-istene 
getDa taEvent listeners 
get£>ata£vcntlistener 



3 ava . uti 1 . EventLi 
interface 

prooessDa ta 
cJeanCp 



j ava - uti 1 . EventO 

I n f aStcvttt vtnt 

In f oSe rverEvent 



rS DafcaEvnt 



dataSourc 




f~~i infoServerEleme 
LTj»rDeI i vmir/Dastl pj t j. o 



getXSLDocuirtent 
addXS LDocument 
r eiaoveXS LDocument 
getLastCheckDate 
setl.astCheckDate 



XSLDocCount 

XSLName 

xslDocs 

defaultMaxQuerySize 

minAllowedQuerylnterv 

address 

formatter 



dataDestmations 



UserDeliveryDestma 
process Da 

cleanOp 



formatter 



DataWorker 

addDataSouxce 

removeDataS ource 

a ddDat aEventL i s te n e r 

removeD a t aEve ntListen 

doWork 

moLaunch 

stop 

getpataEventListener 



□ Seriali2a 
TCSPersisten 



dataEventListeners 
dataS ource 
owner 

dataSources 

dataDestinationa 

saveables 




qetDataStri 



t^3 DataSourc«XSLDitaForroatt«r 



DataSourceXSLDataFormatt 
getDataStnng 
qetTranslatedDocument 



XslDocName 
saveables 



f~l TCSPeraisten 
Datt>Souro«7«ytDat*ForTaatt«r 



DataSourceTextDataForraat 

getDataStnng 

forma tDocument 

f ormatMode 



saveables 



of ClassDiagram infoserver 



H Class tcs . a i n . i nf oserver. Data Event 

D Class tcs.ain.infoserver.DataFormatter 

H Class tcs.ain.infoserver.DataSourceTextDataFormatter 

D Class tcs.ain.infoserver.DataSourceXSLDataFormatter 

D Class tcs.ain.infoserver.DataWorker 

O interface tcs. ain. infoserver. I DataEventListener 

O Interface tcs.ain.infoserver.iDataEventSource 

O Interface tcs. ain. infoserver. IDataSource 

H Class tcs.ai n .infoserver. I nf oServerEvent 

B Class tcs.ain.infoserver.OuervEnfiine 

H Class tcs.ain.infoserver.UserDelivervDestination 

SB Class tcs.ain.infoserver.Worker 



Class Diagram MoreDetailedl 
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& of CJassDiagram infoserver 

B Class tcs.ain.infoserver.ChangeOnlyFilter 



Class tcs.ain.infoserver.ChatUserDestination 

Class tcs.ain Jnfoserver.DatabaseDestination 

Class tcs.ain. infoserver.DataEvent 

Class tcs.ain.infoserver.PataFiiter 

Class tcs.ain. infoserver. DataFormatter 

Class tcs.ain. infoserver. DataSourceTextPataFormatter 

Class tcs.ain.infoserver.DataSourceXSLDataFormatter 

Class tcs.ain. infoserver. DataWorker 

Class tcs.ain. infoserver. EmailUserDestination 

Interface tcs.ain .infoserver. IDataEventListener 

Interface tcs.ain. infoserver. IDataEventSource 



o 
o 
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O Interface tcs.ain.infoserver.iPataSource 

IB Class tcs.ai n . inf oserver. I nf oServerEvent 

B Class tcs.ain.infoserver.JDBCOuervEngine 

B Class tcs.ain.infoserver.NewEmailOuervEngine 

ffl Class tcs.ain.infoserver.PageParserOuervEngine 

B Class tcs.ain.infoservar.OuervEngine 

B Class tcs.ain.infoserver.SearchFilter 

B Class tcs.ain.infoserver.SMSUserDestination 

B Class tcs.ain.infoserver.UserDelivervDesti nation 

B Class tcs . ain. i nf oserver.WebOuervEn gine 



Class Diagram gga 
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interface 
PQAConst 



+DEBUGMODE: boolean 
+MSNU PATH: String 
+ LOGIN PATH: String 
+ RESULT PATH: String 
4-H0W0RKERS PATH: String 



+N0 RESULTS MSG: String 
+USERNAME: String 
+WORKERLI ST : String 
+ CANCEL: String 
+SECTION: String 
-t-LAUNCH : String 
+ RESULTS TAG: String 
+USERNAME TAG: String 



+WORKERLIST TAG: String 
+WORKERID TAG: String 
+INVALIDLOGIN TAG: String 



T 
i 

i 
i 



T 



LCDemoPublicDS 



+ LCDemoPublicDS 
+main: void 



QNe tPQARe source 



-resourceBundle :ResourceBundl 



+getBundle : ResourceBundle 
-initResourceBundle : vo id 
+getString: Stri ng 
+qetlnt : i nt 



WebPagePrinter 
PQAPagePrinter 



-t-PQAPagePrinter 
■t-print :void 



WebMain 



PQAServletMain 



#inf oServerAccess : IRemoteRepo 
#jdbcConn : Connection 
+MainApp: Strin g 
#cursorLimit : i nt 
#cursorCount : int 



+PQAServletMain 
#loadSection : void 
+getWebPagePrinter : WebPagePri 
+qetRMIConnection : IRemoteRepo 



+getDbConnection : Connection 
#cursorAvailable :boole an 
-t-releaseCursor : voi d 
#validateRMI Connection: vo id 
#makeRMIConnection : void 
ttshowRMIError : void 
#showDBError : void 
#validateDbConnection : vo id 
#makeDbConnection:void 



WebPage 



PQAPage 



#userName : String 



+PQAPage 
+PQAPage 

+getHtmlPage : StringBuf f 
+replaceTags : String 



#HtmlPage : StringBuf f er 
#NoWorkersPaqe : StringBuf fe 



+GetPageId: in t 
+PQAMenu 
#getForm: String 
#getTagTable : Hashtable 
#getSelectBoxOptions : Strin 



body: String 




#TAG: String 
#ATTRVAL: String 
# AGE NT ID: String 
#WORKER ID: String 
+LCRESULTS1 PATH: String 
#HtmlPage : StringBuf f er 
#worker!d : String 



+GetPageId:in t 
+POAEBook 
#getForm: String 
#getTagTable : Hashtable 



body: String 



#HtmlPage : StringBuf f er 
#InvalidLoqinMsg : String 



+GetPageId:m t 
+PQALogin 

+ProcessLoqin: Strin g 
#QueryUserInfoDB:ResultSe 
#IsValidLogin : boole an 
#getForm: String 
#getTagTable : Hashtable 



body: String 



#HtmlPage: StringBuf f e 

#worker!d: String 

+GetPageId:in t 
+PQALauncher 
#getForm: String 
#getTagTable : Hashtabl 
body : String 
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Class Nodes 

tcs.ain.infoserver.pqa. 
tcs.ain.infoserver.pqa. 
tcs.ain.infoserver.pqa. 
tcs.ain.infoserver.pqa. 
tcs.ain.infoserver.pqa. 
tcs.ain.infoserver.pqa, 
tcs.ain.infoserver.pqa. 
tcs.ain.infoserver.pqa, 
tcs.ain.infoserver.pqa. 



LCDemoPublicDS 

PQAEBook 

PQALauncher 

PQALogin 

PQAMenu 

PQAPage 

PQAPagePrinter 

PQAServietMain 

QNetPQAResource 



Interface Nodes 

tcs.ain.infoserver.pqa. PQAConst 



I Class tcs.ain.infoserver.pqa. LCDemoPublicDS 
Tests the I MAP Query Engine; query every one minute 

I Class tcs.ain.infoserver.pqa.PQAEBook 
Launch a DataWorker for a given Agent, and return results 

Extends: 

PQAPage 



to Class PQAPage 



III 



I Class tcs.ain.infoserver.pqa. PQALauncher 
Launch a DataWorker for a given Agent, and return results 

Extends: 

PQAPage 



to Class PQAPage 



Class tcs.ain.infoserver.pqa.PQALogin 

USER LOGIN PAGE This prompts user for username/pw and tries and to find (or create) a UserAgent object for them. The UserAgent 
object is inserted into the user's Session under the name 'userAgenf, for retention between screens This will eventually validate against 
and reference the SMS internet Suite Userlnfo database. Note: New agents are created for authenticated users, and their WebProv value 
will be assigned to the agent for name, email, min We will need to keep the agent info up-to-date somehow. 

Extends: 

PQAPage 



G^emllz^omlnnks 
to Class PQAPage 



Class tcs.ain.infoserver.pqa. PQAMenu 

Return a Menu listing of all DataWorkers belonging to a given UserAgent. 

Extends: 

PQAPage 
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to Class POAPage 

I Class tcs.ain.infoserver.pqa.PQAPage 
Launch a DataWorker for a given Agent, and return results 

Extends: 

Web Page 

Implements: 

PQAConst 

to Interface PQAConst 

1 Class tcs.ain.infoserver.pqa.PQAPagePrinter 

Base class for web page printing operations. Provides methods to print the header, banner, etc. Subclasses can provide distinct color / 
font / banner schemes for individual projects or pages 

Extends: 

WebPagePrinter 

3 Class tcs.ain.infoserver.pqa.PQAServletMain 
This is the Main page for the QueryNet PQA Servlet. This loads pages according to the received Section variable 

Extends: 

WebMain 

Implements: 

PQAConst 



to Interface PQAConst 

B Class tcs.ain.infoserver.pqa.QNetPQAResource 

This class is a singleton for a property resource bundle to be used by the QueryNet PQA Servlet. The resource bundle contains values 
that could potentially be displayed to users. It also provides a direct, static method for safely getting String values without worrying 
about MIssingResourceExceptions ras; 2/29/99; modified by S. Levine on 5/01/00 

interface Node Detail ■ 

& Interface tcs.ain.infoserver.pqa. PQAConst 

The Interface is a contains common constants which apply to the QueryNet PQA Interface, modified by S. Levine on 9/9/99 



Class Diagram servlet 
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Class Nodes 

tcs.ain.infoserver.serviet.AddEditServicesPage 

tcs.ain.infoservenservlet.CreateNewSourceForm 

tcs.ain.infoserver.servlet.CustomizeAgentForm 

tcs.ain.infoserver.servlet.CustomSourceForm 

tcs.ain.infoserver.servlet.DataSourceForm 

tcs.ainJnfoserver.serviet.DataWorkerForm 

tcs.ain.infoserver.servlet.DataWorkerWizardForm 

tcs.ain.infoserver.servIet.DestinationForm 

tcs.ainJnfoserver.servletinfoSvrMain 

tcs . a i n . i nf oserver . servi et . i nf oSvr Page 

tcs.ain.infoserver.servletlSEIementCreatorException 

tcs.ain.infoserver.servletiSEIementLoader 

tcs.ain.infoserver.servlet.lSServletException 

tcs . a i n , t nf oserver. servlet. Logi n Page 

tcs.ain.infoserver.servlet.MainMenuPage 

tcs.ain.infoserver.servlet.PublicSourceForm 

tcs.ain.infoserver.servlet.QNServiceCreator 

tcs.ain.infoserver.servlet.QNServletResource 

tcs.ain.infoserver.servtet.QNWebPagePrinter 

tcs.ain.infoserver.servlet.QueryNetResource 

tcs. a i n . i nf oserver. servlet. Statu s Form 

tcs.ain.infoserver.servlet.ViewServicesPage 

Interface Nodes 

tcs.ain.infoserver.servlet.lSEIementCreator 

if' 

Si IB Class tcs.ain.infoserver.servlet.AddEditServicesPage 

m 

1|| Extends: 

J: InfoSvrPage 

3 



s to Class InfoSvrPage 

o 

p.|H Class tcs.ain.infoserver.servlet.CreateNewSourceForm 
W Define the Data Sources that are desired. 

si 

Extends: 

DataWorkerWizardForm 

to Class DataWorkerWizardForm 
H Class tcs.ain.infoserver.servletCustomizeAgentForm 

Define the Data Sources that are desired. 

Extends: 

DataWorkerWizardForm 

to Class DataWorkerWizardForm 
B Class tcs.ain.infoserver.servlet.CustomSourceForm 



Define the Data Sources that are desired. 
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Extends: 

DataWorkerWizardForm 



to Class DataWorkerWizardForm 

Class tcs.ain.infoserver.servletDataSourceForm 
Extends: 

tcs.ain.infoserver.serviet.DataWorkerWizardForm 

to Class DataWo rke rW i za rd Form 

Class tcs.ain.infoserver.servlet.DataWorkerForm 
Define the Data Sources that are desired. 

Extends: 

DataWorkerWizardForm 

to Class DataWorkerWizardForm 
Class tcs.ain.infoserver.servlet DataWorkerWizardForm 

Base class for elements that will show info about a DataWorker Subclasses will access each component that a DataWorker cares about 

Class tcs.ain.infoserver.servlet DestinationForm 
Define the Data Sources that are desired. 

Extends: 

DataWorkerWizardForm 

to Class DataWorkerWizardForm 
1 Class tcs.ain.infoserver.servletlnfoSvrMain 

This is the Main page for the Info Server Web Application. This loads pages according to the received Section variable 

Extends: 

WebMain 

3 Class tcs.ain.infoserver.servlet InfoSvrPage 

Extends: 

WebPage 



I Class tcs.ain.infoserver.servlet ISEIementCreatorException 

Extends: 

ISServletException 
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to Class ISServletExceotion 

Class tcs.ain.infoserver.servletlSEIementLoader 

to Interface ISEiementCreator 

Class tcs.ain.infoserver.servletlSServletException 

Extends: 

Exception 

Class tcs.ain.infoserver.servlet.LoginPage 

USER LOGIN PAGE. This prompts user for username/pw and tries and to find (or create) a UserAgent object for them. The UserAgent 
object is inserted into the user's Session under the name 'userAgent' , for retention between screens This will eventually validate against 
and reference the SMS Internet Suite Userlnfo database. Note: New agents are created for authenticated users, and their WebProv values 
will be assigned to the agent for name, email, min We will need to keep the agent info up-to-date somehow. 

Extends: 

InfoSvrPage 

to Class InfoSvrPage 

Class tcs.ain.infoserver.servlet.MainMenuPage 

MAIN MENU PAGE. This will provide the main options for the app. 

Extends: 

InfoSvrPage 

to Class InfoSvrPage 
! Class tcs.ain.infosetver.servlet.PublicSourceForm 

Define the Data Sources that are desired. 

Extends: 

DataWorkerWizardForm 

to Class Da ta Wo rke rWi za rd Form 

I Class tcs.ain.infoserver.servletQNServiceCreator 
S. Levineon 11/1/99 

Implements: 

ISEiementCreator 

to Interface ISEiementCreator 
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I Class tcs.ain/mfoserver.servietQNServletResource 

This class is a singleton for a property resource bundle to be used by the Query Net Wizard. The resource bundle contains values that 
could potentially displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
MIssingResourceExceptions ras; 2/29/99; modified by S. Levine on 9/9/99 

I Class tcs.ain.infoserver.servletQNWebPagePrinter 

Extends: 

tcs.web.WebPagePrinter 

I Class tcs.ain.infoserver.servlet.QueryNetResource 

This class is a singleton for a property resource bundle to be used by the Query Net Wizard. The resource bundle contains values that 
could potentially displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
MIssingResourceExceptions ras; 2/29/99; modified by S. Levine on 9/9/99 

1 Class tcs.ain.infoserver.servletStatusForm 
Define the Data Sources that are desired. 

Extends: 

DataWorkerWizardForm 

to Class DataWorkerWizardForm 

i Class tcs.ain.infoserver.servlet.ViewServicesPage 

Extends: 

InfoSvrPage 

to Class InfoSvrPage 



& Interface tcs.ain.infoserver.servlet.lSEiementCreator 



Class Diagram simplel 
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InfoServerEleme 
IDataEventListen 
. . XTserDellveryDestxnatlon 


#dataDestinations : Vector 




+UserDeliveryDestination 




■hprocessData : void 




+cleanUp: void 


formatter : DataFormatter 

fl 



Inf oServerEve 
tcs . ain . inf oserver . DataEv 



fsource: IDataSource 



+DataEvent 



dataSource : IDataSource 

a 



InfoServerEleme 
tcs . ain . inf oserver . UserAgent 



-lName: String 
-fName : String 



-fUserAgent 
+startWorkers : void 
+stopWorkers : void 
+getDataWorker : DataWorker 
+addElement : void 
+removeEleraent : void 



allElements : Inf oServerElem 
allDataWorkers : DataWorker [ 
workerlds : Vector 
LName : String 
FName: String 
mobileNumber : String 
email : String 
userElements: Vector 
saveables : Obj ect [ ] 



Worker 
IDataEventSourc 
tcs . ain . inf oserver . DataWorker 



+DataWorker 
+addDataSource : void 
+removeDataSource : void 
+addDataEventListener : void 
+removeDataEventListener : voi 
-fdoWork: void 
+stop: void 

+getDataEventListener : IDataE 



dataEventListeners : Enumerat 
dataSource : QueryEngine [ ] 
owner :0b j ect 
dataSources : Vector 
dataDestinations : Vector 
saveables : Obj ect [ ] 



basic elements 




Class Diagram simpleweb 
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Cus tonfWebSour ceGenerator 

+SaveButtonId: Stri ng 
returnJsp : String , 



+CustomWebSourceGenerator 
+getFormForDataWorker: String 
■f getNewFormHtml : String 
#getFormHtml : String 
+getPageParserQueryEngineFrom 
#getPageParserQueryEngine : Pag 
#isValidLabel : boolean 
#getConfidence!con: String 



OserWorkFonnGenerator 

-f-WorkerFld: Strin g 

+IsRunninaFId: Stri ng 

#inf oServerAccess : IRemoteRepo 

# agentWor ker s : DataWorker [ ] 

#userData:UserData 

#userAgent : User Agent 



+UserWorkFormGenerator 
+getForms : String [ ] 
#getIsRunnmgField:StringBuff 
#getChangeOnlyField: StringBuf 
#getTimerFields : StringBuf fer 
tgetDestmationf ields : StringB 
#DoesSourceHaveEmaiIListener: 



DoesSourceHaveSmsListener : boo 



UserWorkPormProces sor 

#inf oServerAccess : IRemoteRepo 
#userData :UserData 
#userAgent :UserAgent 
#dataWorker: DataWorker 
request :HttpServletRequest 



+UserWorkFormProcessor 
+processForm: boolean 
#applyIsRunnmg: void 
#applyTimerFields:void 
#getWorkerChangeOnlyFilter:Ch 
#applyChangeOnly : void 
#applyDestinationFields:void 
#removeEmailSupport : void 
# remove Sms Support : void 
#addEmai 1 Support : void 
#addSms Support : void 



Except io 

Inval idParame terExcep tion 



+InvalidParameterExcepti 



Cus toraEmailSourceGenerator 



+createEmailQuery£ngine:NewEm 
#isValidMailHost: boolean 



5# 



java. lang.Obje 
Publi cAgentLis tGenera tor 



#inf oServerAccess : tcs . ain. inf 
#agentWorkers :tcs .am. infoser 
#userData : tcs . ain.appdata .Use 
ftuserAgent : tcs . ain . inf oserver 



+PublicAgentListGenerator 
forms : j ava . lang . String [ ) 



java. lang. Obj< 
Cas tonWebSourceFormGenera tor 



+SaveButtonId: java. lang. St rin 



returnJsp : p ava .lang . String 
+CustomWebSourceFormGenerator 
+getPageParserQueryEngineFrom 
#getFormHtml : java . lang . String 
+get FormForDataWorker : j ava . la 
+ge tNewFormHtml : j ava . lang . St r 
getPageParserQuervEngine : tcs . 



JspBean 



UserAgent Id: Stri ng 
UserData] d : Strin g 
+ChangeWorkerButtonId: Strin g 
•fDeleteWorkerButtonld; Str ing 
-fCreatePublicWorkerButtonld: S 



# inf oServerAccess : IRemoteRepo 
#userDb:SMSAppDB 
#jdbcConn : Connection 
#dbCheckSgl : String 



+JspBean 
+logout :void 
+login: boolean 
+isSysteraAvailable : boolean 
+isValidSession: boolean 
+getUserData : UserData 
+processCustomWorkerCreateReq 
+processPublicWorkerCreateReq 
+getCreatePublicWorkerForm: St 
+getWorkerCount : int 
+processWorkerChangeRequest : b 
+getAgentWorkerEdit Forms: Stri 
tfgetUserAgent : UserAgent 
IfvalidateRMIConnection : boolea 
#makeRMIConnection: void 
#makeDbConnection : void 
#validateDbConnection : void 
+ShouldWorkerQueryAlwavs : bool 



+main: void 



systemAvailable : boolean 
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Class Nodes 

tcs.ain.infoserver.simpleweb.CustomEmaiiSourceGenerator 
tcs.ain.infoserver.simpleweb.CustomWebSourceFormGenerator 
tcs.ain.infoserver,simpleweb.CustomWebSourceGenerator 
tcs.ain.infoserver.simpleweb.lnvalidParameterException 
tcs.ain.infoserver.simpleweb.JspBean 
tcs.ain.infoserver.simpleweb.PublicAgentListGenerator 
tcs.ain.infoserver.simpieweb.UserWorkFormGenerator 
tcs.ain.infoserver.simpleweb.UserWorkFormProcessor 

B Class tcs.ain/mfoserver.simpleweb.CustomEmailSourceGenerator 

This class is used to generated a customer Email Source 

H Class tcs.ainJnfoseiver.simpieweb.CustomWebSourceFormGenerator 

Extends: 

java.lang.Object 

B Class tcs.ainJnfoserver.simpleweb.CustomWebSourceGenerator 
^, This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources 

\jfi Class tcs.ainjnfoseiver.simplewebJnvalidParameterException 

This can be thrown whenever a JSP passes parameters to an object and the parameters are missing, invalid, etc. 



Ill 



Extends: 

Exception 



Class tcs.ain.infoserver.simpieweb.JspBean 



f\\ This provides some methods to simplify access to QNet and also return some dynamic HTML content. 



I If 



Qm Class tcs.ainjnfosewer.simpteweb.PublicAgentListGenerator 

L;i Extends: 

java.lang.Object 

B Class tcs.ainJnfoseiver.simpleweb.UserWorkFormGenerator 

This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources TO 
DO: Remove hard-coded English in the form use more constants for field ids 

B Class tcs.ainJnfoserver.simpleweb.UserWorkFormProcessor 

This guy applies change requests for a worker against the useragent, which is obtained by querying the session 



Class Diagram source 
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Class Diagram tests 



Testll 



+Testll 
+main: voi 



WLabDS 



+WLabDS 
+main: voi 



java. lang .Obj 
Test4 



+Test4 
+main: void 



Test8 



+Test8 
+main: voi 



Test2 



+Test2 
+main: voi 



Tests 



+Test5 
+main: voi 



Test7 



+Test7 
+main: voi 



Tes tPageParserQE 



+TestPageParserQE 
+main: void 



Testl 



+Testl 
+main: voi 



Testl2 



rep: IRemoteRepository 
user Agent : UserAgent 
agentWorkers : DataWorker 



+Testl2 

fshowlnf o : void 
#showUserMatch : void 
fshowAllUserWorkers : voi 
+main: void 



Test6 



+Test6 
+main: voi 



Test3 



+Test3 
+main: voi 



Test9 



+Test9 
+main: voi 



TestlO 



+TestlO 
+main: voi 



GSWDS 



+GSWDS 
•Hmain: voi 



Class Nodes 

tcs.ain.infoserver.tests.GSWDS 

tcs.ain.infoserver.tests.Testl 

tcs.ain.infoserver.tests. TestlO 

tcs.ain.infoserver.tests.Testl 1 

tcs . ai n. i nfoserver. tests .Test 1 2 

tcs.ain.infoserver.tests.Test2 

tcs.ain.infoserver.tests.Test3 

tcs.ain.infoserver.tests.Test4 

tcs.ain.infoserver.tests. Test5 

tcs.ain.infoserver.tests.Test6 

tcs.ain.infoserver.tests.Test7 

tcs.ain.infoserver.tests.Test8 

tcs . ain . i nfoserver. tests . Test9 

tcs.ain.infoserver.tests.TestPageParserQE 

tcs.ain.infoserver.tests. WLabDS 
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Class tcs.ain.infoserver.tests.GSWDS 

Tests the I MAP Query Engine; query every one minute 

Class tcs.ain.infoserver.tests.Testl 

This class create a WebQueryEngine, 2 DataWorkers, SimpleUserDestination and ties them ail together. The dataworker wili execute 
once, causing the XML from the horoscope web page to be seen on the screen. 

Class tcs.ain.infoserver.tests. Testl 0 
Adds on to Test3 by saving to the Repository. 

Class tcs.ain.infoserver.tests.Testl 1 

Tests the I MAP Query Engine; query every one minute 

Class tcs.ain.infoserver.tests. Testl 2 

This test just shows all of the Data Sources and interleaves userUser info if the user has 'signed up' with this source, then user info is 
shown. 

Class tcs.ain.infoserver.tests. Test2 

Adds on to Testl by assigned an XSL doc to the DataSource, and assigning a formatter that uses that XSL doc. 

Class tcs.ain.infoserver.tests.Test3 

Adds on to Test2 by using the CalendarTimer. 
Class tcs.ain.infoserver.tests. Test4 

Extends: 

java.lang.Object 

Class tcs.ain.infoserver.tests. Tests 

Loads the objects saved in Test4. Workers wili start to auto-run. This is what InfoServer.main does also. 
Class tcs.ain.infoserver.tests. Test6 

Gets the InfoserverAccess object. Creates an UserAgent and saves it to the InfoServerAccess remote object. 
Class tcs.ain.infosen/er.tests. Test7 

Gets the InfoserverAccess object Retrieves the UserAgent saved in Test6. 

Class tcs.ain.infoserver.tests.Test8 

Tests the I MAP Query Engine; query every one minute 

Class tcs.ain.infoserver.tests. Test9 

Single worker, single data source for I MAP, with 2 XSL styles. Two destinations, each using a different style sheet. Dest 1 inserts the 
Email data into a database for the IVR reader Dest 2 displays the at the MIN. 
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Class tcs.ain.infosen/er.tests. TestPageParserQE 

This creates a PageParserQueryEngine and has a DataWorker query it 

Class tcs.ain.infoserver.tests. WLabDS 

Tests the IMAP Query Engine; query every one minute 



Class Detail 



B Class tcs.ain.infoserver.access.InfoServerAccess 

public class Inf oServerAccess 
Extends: 

java . rm L se rver. U n i ca st Rem oteO b ject 

Implements: 

tcs.ain.infoserver.accessJRemoteRepository 
This class provides access to user agents within the Info Server. May be replaced by a Jini Service in the near future. This provides access to 
the assigned Repository 

^Attributes 

."3* repository 

SlConstructors 

W I nf oServerAccess(Repository) 

||! 

^Operations 

l\l addUserAgent(UserAgent) 

%i getQueryEngine(String) 

W getQueryEngines() 

s getUserAgent(String) 

pi getWorkerldsFromAgent(String) 

3J isConnectedO 

W launchWorker(String, String, Hashtable) 

fl| launchWorker(String, String) 

ft repository 

protected Repository repository 
The repository which we represent. 



i5> Inf oServerAccess 

public Inf oServerAccess (Repository r) 

Construct with this repository and register the 'Inf oServerAccess* name. 

Throws: 

RemoteException 
MalformedURLException 



• addliserAgent 

public void addUserAgent (UserAgent ua) 
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Pass through the add, but also force a save of ail agents. 

Throws: 

InfoServerException 
RemoteException 

• getQueryEngine 

public QueryEngine getQueryEngine (String id) 
Direct passthrough for the get 

Throws: 

RemoteException 

• getQueryEngines 

public Hashtable getQueryEngines () 
Direct passthrough for the get 

Throws: 

RemoteException 

ft getUserAgent 

public UserAgent getUserAgent (String id) 
Q Direct passthrough for the get 

Throws: 

^ RemoteException 

si 

yjft getWorker Ids From Agent 

!%public Vector ge tWorker I dsFromAgent (String agentld) 
fjfjj Return all id's associated with a specified agent 

% Throws: 

Ij! RemoteException 

f\$9k isConnected 

U.public boolean isConnected ( ) 

Used for testing an RMI Connection. Always sends true. If client calls this and no connection has been establishished then they will get an 
exception 

Throws: 

ElementNotFoundException 
RemoteException 

• launchWorker 

public String launchWorker (String agentld, String workerld, Hashtable htParams) 
Call the specidied workers doWork method, pass in parameters. 

Throws: 

InfoServerException 
RemoteException 

• launchWorker 

public String launchWorker (String agentld, String workerld) 
Call the specidied workers doWork method 

Throws: 

InfoServerException 
RemoteException 
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B Class tcs.ain.infoserver.access.lnfoServerAccess Skei 

public final class Inf oServerAccess_Skel 

Extends: 

java.iang.Object 

Implements: 

java. rmi. server. Skeleton 

Attributes 

interfaceHash 
operations 

Constructors 

lnfoServerAccess„Skei() 

Operations 

dispatch(java. rmi. Remote, java. rmi. server. RemoteCall, int, long) 
getOperationsQ 



• interfaceHash 

^private static final long interfaceHash 



-Jfl operations 

^private static final java . rmi . server .Operation [ 3 operations 



SSI lnfoServerAccess_Skel 

^public lnfoServerAccess_Skel {) 

dispatch 

Iw^public void dispatch (java . rmi .Remote , j ava. rmi . server .RemoteCall, int, long) 

& getOperations 

public java. rmi . server .Operation [] getOperations ( ) 



H Class tcs.ainJnfoserver.access.lnfoServerAccess_Stub 

public final class Inf oServerAccess_Stub 

Extends: 

java, rmi. server. RemoteStub 

Implements: 

tcs.ain.infoserver.access.lRemoteRepository 
java. rmi. Remote 



Attributes 

interfaceHash 
operations 

Constructors 

lnfoServerAccess_Stub() 

! nf oServerAccess_Stub(java. rm i .server. RemoteRef ) 
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Operations 

addUserAgent(tcs.ain.infoserver.UserAgent) 

getQueryEngine(java.lang.String) 

getQueryEngines() 

getli ser AgentQava . I a ng. S tr i ng) 

getWorkerl dsFromAgent(java . ! ang. Stri ng) 

isConnectedQ 

SaunchWorkerflava.lang.String, java.lang.String, java.utii.Hashtable) 
iaunchWorker(java.!ang.String, java.lang.String) 



rte Detail 



ft interfaceHash 

private static final long interfaceHash 

ft operations 

private static final java . rmi . server .Operation [] operations 



l§ InfoServerAccessJJtub 

public Inf oServerAccess_Stub ( ) 

<^ InfoServerAccessJ>tub 

^public Inf oS erver Accesses tub (java. rmi . server . RemoteRef) 

||p addUserAgent 

£ public void addUserAgent (tcs .ain. inf o server .Us erAgent) 

fill getQueryEngine 

Republic tcs .ain.infoserver.QueryEngine getQueryEngine (java . lang . String) 
CI* getQueryEngines 

^public java.util .Hashtable getQueryEngines ( ) 
ft getUserAgent 

public tcs . ain . inf oserver . UserAgent getUserAgent { j ava . lang . String ) 

ft getWorkerldsFromAgent 

public java.util .Vector getWorkerldsFromAgent (java . lang. String) 

ft isConnected 

public boolean isConnected ( } 
ft launchWorker 

public java.lang.String launchWorker (java. lang .String, java.lang.String, java.util .Hashtable 
ft launchWorker 

public java.lang.String launchWorker (java . lang. String, java.lang.String) 
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H Class tcs.ain. infoserver. CalendarTimer 

public class CalendarTimer 

Extends: 

tcs.ain. infoserver.Timer 

Implements: 

java.io.Serializable 

This Timer will tell the worker to doWork whenever the assigned time criteria have been met. Similar to a cron job, it receives minutes, 
hours, days of week, and days of month values that define when the work should be performed. Currently this just checks its TimeElements 
every 60 sees to see if it should fire. Perhaps later we can sleep the maximum amount possible given the assigned values. 

Attributes 

Always 

DefaultSleepTime 

domElement 

dowElement 

executeQuantity 

hourElement 

minuteElement 

sleepTime 

Constructors 

CalendarTimer() 

^Operations 

i|| getDomElement() 

%| getDowElementQ 

^1 getExecuteQuantityO 

?y getHourElement() 

111 getMinuteElement() 

getSaveabies() 

IV* getSleepTimeO 

run o 

III setDomElement(TimeElement) 

- setDowElement(TimeElement) 

&i setExecuteQuantity(int) 

y setHourElement(TimeEiement) 

flj setMinuteElement(TimeElement) 

f|l setSaveables(ObjectQ) 

yj setSleepTime(long) 

^ timeToFire() 




ft Always 

public static final int Always = -1 
If a value = this, then impose no limits on it. 

ft DefaultSleepTime 

protected static long DefaultSleepTime = 60 * 1000 
The default sleep time to wait before checking if we should fire 

ft domElement 

protected TimeElement domElement = new TimeElement ( ) 

ft dowElement 

protected TimeElement dowElement = new TimeElement { ) 



ft executeQuantity 

protected int executeQuantity = Always 
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How many times the timer should fire. 

• hourElement 

protected TimeElement hourElement = new TimeElement ( ) 
ft minuteElement 

protected TimeElement minuteElement = new TimeElement ( ) 

• sleepTime 

protected long sleepTime = Def aultSleepTime 

how long 1o sleep before checking to see if it is time to fire an event 




ft CalendarTimer 

public CalendarTimer {) 




_ ft getDomElement 

^public TimeElement getDomElement { ) 
'^l tgGet 

tflft getDowElement 

^public TimeElement getDowElement ( ) 

m 

II tgGet 

rift getExecuteQuantity 

111 public int getExecuteQuantity ( ) 
tgGet 

J ft getHourElement 

public TimeElement getHourElement ( ) 
tgGet 

ft getMinuteElement 

public TimeElement getMinuteElement ( ) 
tgGet 

ft getSaveables 

public Object [] getSaveables ( ) 

Return an array of all objects that should be persistent primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 

ft getSleepTime 

public long getSleepTime ( ) 
tgGet 
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ft run 

public void run() 

Check to see if it is time to tell the worker to work. Then sleep and do it again. 

ft setDomElement 

public void setDomElement {TimeElement domElement) 
tgGet 

ft setDowEIement 

public void setDowEIement (TimeElement dowElement) 
tgGet 

ft setExecuteQuantity 

public void setExecuteQuantity ( int executeQuantity) 
tgSet 

ft setHourElement 

public void setHourElement (TimeElement hourElement) 
tgGet 

^ft setMinuteEIement 

ft I 

Sjpublic void setMinuteEIement (TimeElement minuteElement) 
*P tgGet 

5 a ii 

Sift setSaveables 

^public void setSaveables {Object [] oa) 

Ph receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
1H handle Null values in the array. 

Ill 

Oft setSleepTime 

J-^public void setSleepTime (long sleepTime) 
tgSet 

ft timeToFire 

protected boolean timeToFire () 

Check each timeEiement against the current time, if they all have a match, then return true 

B Class tcs.ain.infoserver. ChangeOnlvFilter 

public class ChangeOnlvFilter 

Extends: 

tcs.ain.infoserver.DataFilter 

Just send the output to STDOUT. 

Attributes 

lastChecksum 

Operations 

getChecksum(String) 
getDTDQ 
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getLastChecksum() 
getSaveabiesO 
getXMLStreamO 
getXSLDocCountO 
getXSLDocument(String) 
getXSLName(int) 
moFiiter(DataEvent, Hashtabie) 
notifyDestinations(DataWorker, i DataSource) 
processData(DataEvent) 
setLastChecksum(iong) 
setSaveables(ObjectQ) 

* lastChecksum 

protected long lastChecksum = 0 

the checksum code of the page the last time we checked. This origPagelsMaster flag determines whether this checksum always refers the 
page First loaded 

9 getChecksum 

protected long getChecksum (String chkString) 
%l Query the target url and return the checksum value for its content& Throw back any lOEXception that we encounter. 

U Throws: 

|| lOException 

|J* getDTD 

ijpublic DTD getDTD ( ) 

■,.13, 

return a DTD describing the XML that can be retreived using the XML Stream. 

!!|# getLastChecksum 

I|public long getLastChecksum ( ) 

II 

!!• getSaveables 

^public Object!] getSaveables ( ) 

Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 

9t getXMLStream 

public InputStream getXMLStreamO 

Return an input stream by which an XML document can be read. We return an INputStream rather than just a DOM XML document 
because: - some data may be too large to process as a single unit - this way multiple XML parsing techniques (SAX t DOM, etc) can be 
used at the discretion of the client. The XML Stream does NOT included DTD info. 

Throws: 

I nf oServerException 

9 getXSLDocCount 

public int getXSLDocCount ( ) 

How many XSL documents are provided for presenting the data 

» getXSLDocument 

public org .w3c .dom. Document getXSLDocument (String name) 
The actual XSL Document with this name 
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m getXSLName 

public String getXSLName (in t idx) 

The descriptive name for XSL document with this index position (0-based) 

• moFilter 

public String moFilter {DataEvent evt, Hashtable htParams) 
Filter and return data form mobile originated query. 

• notifyDestinations 

protected void notif yDestinations (DataWorker dw, IDataSource ds) 
Execute processData() method of all member Destinations 

Throws: 

InfoServerExceptton 

9k processData 

public void processData (DataEvent evt) 

I have new data; Check to see if checksum value for data has changed 

• setLastChecksum 

f -public void setLastChecksum (long lastChecksum) 

{1$ setSaveables 

flpublic void setSaveables (Object [] oa) 

Ul receive an array of objects that have been saved, the order will correspond to that specified when getSaveabies was called. Users should 
JlJ handle Null values in the array. 




Class tcs.ain.infoserver. ChangeOnlvFilter.XMLInputStream 



pplass XMLInputStream 
fljExtends: 

HI java.io.lnputStream 

ilpperations 

read() 

• read 

public int readO 

Throws: 

10 Except ion 

B Class tcs.ain.infoserver. ChatUserDestination 

public class ChatUserDestination 
Extends: 

tcs.ain.infoserver.UserDeliveryDestination 
Send the output to a user's email account. SMTP- relevant info must first be defined for the class. 

Attributes 

alias 
channel 
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chatServer 

DefaultSmtpPort 

ircSession 

port 

user Info 

Constructors 

ChatUserDestination() 

Operations 

cleanUp() 

getAlias() 

getChannelO 

getChatServerO 

getPort() 

getSaveablesO 

onWorkerError(DataWorker, String) 

processData(DataEvent) 

setAlias(String) 

setChannel(String) 

setChatServer(String) 

setPort(int) 

setSavea b I es(Object[]) 




ClSI alias 

^|?rivate String alias = null 

l^l User Nickname to be referred to by chat server 

"JP channel 

f s private String channel = null 

HI Channel(destination) in Chat Server to send message to. 

pp chatServer 

fljprivate String chatServer = null 
*' ^ Name of chat server 

C! 

CP DefaultSmtpPort 

private static int DefaultSmtpPort 

H ircSession 

private IRCClientConnection ircSession = null 
Used to establish connection to IRC Server, 
transient 

• port 

private int port 

Port that chat server is using 

* userlnfo 

private Userlnfo userlnfo = null 

Object for storing user information required for response messages by the IRC Server. This is a requirement of the server and is not used 
by ChatUserDestination. 

transient 
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Constructor Detail 



9 ChatUserDestination 

public ChatUserDestination (} 
Constuctor 

Parameter doc: 

alias 

destination 
chatServer 
port 



» cleanup 

public void cleanup () 
Clean up Session Object 

Parameter doc: 

evt 

getAlias 

J|public String getAlias (} 

%k getChannel 

^public String getChannel (} 
IS? Get 

0* getChatServer 

Bf public String getChatServer ( ) 
m Get 



IfcgetPort 

public int getPortO 
Get 

!§- getSaveables 

public Object [] getSaveables ( ) 

Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 

• onWorkerError 

protected void onWorkerError (Da taWorker worker, String errorMsg) 

Stop DataWorker, save error message to log, save worker to agent, and save agent to database 

• processData 

public void processData (DataEvent evt) 

I have new data; Send the Data to the specified IRC Server. 

Throws: 

ChatUserDestinationException 
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Parameter doc: 

evt 

• setAIias 

public void setAIias (String alias) 

Parameter doc: 

alias 

• setChannel 

public void setChannel (String channel) 

Parameter doc: 

channel 

• setChatServer 

public void setChatServer (String chatServer) 

Parameter doc: 

chatServer 

9t setPort 

Plpublic void setPort(int port) 

f % 

r*l Parameter doc: 

port 

m 

WMi setSaveables 

sis 

^public void setSaveables (Ob j ect [] oa) 

m receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
v,rv - handle Null values in the array. 

flfB Class tcs.ain.infoserver.ChatUserDestinationException 

2f public class ChatUserDestinationException 
^Extends: 

r! tcs. ai n . infoserver. I nf oServerException 

Constructors 

ChatUserDestinationException(String) 

9t ChatUserDestinationException 

public ChatUserDestinationException {St ring s) 



H Class tcs.ain. infoserver. ConditionFilter 

public class ConditionFilter 

Extends: 

java.lang.Object 

Implements: 

tcs. ain. infoserver. I DataEventListener 
tcs .a i n . i nf oserver. I Data EventSou rce 
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Constructors 

ConditionFilter() 

Operations 

addDataEventListener(tcs.ain.infoserverJDataEventListener) 
get Data EventLi s tener( java . I ang. S t ri ng) 

getDataEventListeners() 

processData(tcs.ain.infoserver.DataEvent) 

removeDataEventListener(tcs.ain.infoserver.iDataEventListener) 



• ConditionFiiter 

public ConditionFiiter 0 



9: addDataEventListener 

public void addDataEventListener (tcs .ain. infoserver . IDataEventListener) 

ft getDataEventListener 

^public tcs . ain . infoserver . IDataEventListener getDataEventListener ( java . lang . String) 

J{d getDataEventListeners 

^public java.util. Enumeration getDataEventListeners () 

fit 

Jp# processData 

hipublic void processData (tcs. ain. infoserver. DataEvent) 

§ 

„ § removeDataEventListener 

republic void removeDataEventListener (tcs .ain. infoserver . IDataEventListener) 

l 

pj B Class tcs.ain. infoserver. DatabaseDestination 

Q public class DatabaseDestination 

^ Extends: 

tcs.ain. infoserver.UserDeliveryDestination 

This performs SQL statements that must be embedded within the received XML data. This assumes that an XSLTemplate assigned 
(DataFormatler)DataSourceXSLDataFormatter will provide XML data in the following format: 

<STATEMENTS><SQL>xxxxx</SQLx/STATEMENT> It will then execute each statement against the schema assigned to it. 



Attributes 

classname 

connection 

pw 

uri 

user 



Constructors 

DatabaseDestinationQ 
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makeDbConnection() 

processDa1a(Data Event) 

setCiassname(String) 

setPw(String) 

setSaveab!es(Object[]) 

setUrl(String) 

setUser(String) 

validateDbConnectionQ 



ft classname 

protected static String classname 

• connection 

protected static Connection connection 
B: pw 

protected static String pw 

* url 

protected static String url 

im user 



^protected static String user 



bjfl DatabaseDestination 

lllpublic DatabaseDestination ( ) 

1., Construct and make the connection using the provided data. 



• cleanllp 

^public void cleanup () 
Clean Up 

• doSqIStatement 

protected void doSqIStatement (String sqlStmt) 
Do this SQL statement; throws any error it encounters 

Throws: 

SQLException 
Exception 

• getCIassname 

public String getCIassname ( ) 
tgSet 

1 getPw 

public String getPw() 
tgSet 
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• getSaveables 

public Object [] getSaveables ( ) 

Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 

9t getUrl 

public String getUrlO 
tgSet 

• getUser 

public String getUser() 
tgSet 

• makeDbConnection 

protected static void makeDbConnection ( ) 

Make sure connection is valid. If not, report the error to out and return false 

Throws: 

SQLException 
Exception 

ygJSI processData 

public void processData {DataEvent evt) 

It! 

Get data from the DataSource, convert to XML, and write to the database each <SQL> statement. 

Ill 

jr= Throws: 

= 1 = DatabaseDestinationException 
^ setClassname 

ppublic void setClassname (String classname) 

m 

l:; tgGet 
gll setPw 

^public void setPw (String pw) 
tgGet 

• setSaveables 

public void setSaveables {Object [] oa) 

receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
handle Null values in the array. 

• setUrl 

public void setUrl (String url) 
tgGet 

• setUser 

public void setUser (String user) 
tgGet 

SI validateDbConnection 

protected static void validateDbConnection ( ) 
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Make sure con is valid. If not, report the error to out and throw the exception 

Throws: 

SQLException 
Exception 



B Class tcs.ainJnfosewer.DatabaseDestinationException 

public class DatabaseDestinationException 
Extends: 

tcs.ain.infoserver.infoServerException 

Constructors 

DatabaseDestinationException(String) 



II DatabaseDestinationException 

public DatabaseDestinationException (String s) 



H Class tcs.ain.infoserver. Data Event 

Wpublic class DataEvent 
Extends: 

^ tcs . a i n. i nf oserver. I nf oServerEvent 

^Jfevent fired to a DataDestination whenever new data is available. This provides a reference to the Data Source containing the new data. It is 
¥ lip to the receiver to get the data if it wants it. 

UlAttributes 

W source 

f Constructors 

ftl DataEvent(Object, IDataSource) 

reoperations 

w- getDataSourceQ 




• source 

protected IDataSource source 

This is the object containing the new/updated data 



"3B 



• DataEvent 

public DataEvent {Object caller, IDataSource ds) 



• getDataSource 

public IDataSource getDataSource ( ) 
tgGet 
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H Class tcs.ain.infoserver.DataFilter 

public abstract class DataFilter 
Extends: 

tcs.ain.infoserverJnfoServerEiement 

Implements: 

tcs.ain.infoserver. IDataEventListener 
tcs.ain.infoserver.lDataEventSource 
tcs.atn. i nf oserver. 1 DataSource 

Just send the output to STDOUT. 

Attributes 

data Destinations 

formatter 

xsiDocs 

Operations 

addDataEventListener(IDataEventListener) 
cleanUpO 

copyXsiDocs(IDataSource) 

getDataDestinations() 

getDataEventListener(String) 

getDataEventListeners() 

getDTDO 
J | getFormatterO 
Jl getXSLDocCountO 

getXSLDocument(String) 
y getXSLName(int) 
{J| moFilter(DataEvent, Hashtabie) 
ill processData(DataEvent) 
%l removeDataEventListener(IDataEventListener) 

setData Desti nati on s(Vector) 
fif setFormatter(DataFormatter) 

flfl dataDestinations 

fljbrivate Vector dataDestinations = new Vector () 

pi Associates: 

r? IDataEventListener 

• formatter 

protected DataFormatter formatter = new DataFormatter ( ) 
Default Data Formatter 

xsiDocs 

protected Hashtabie xsiDocs 

Hashtabie of XSL Documents, keyed on the descriptive name 

• addDataEventListener 

public void addDataEventListener (IDataEventListener dd) 
ft cleanllp 

public void cleanup {) 
Clean Up 
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• copyXslDocs 

protected void copyXslDocs (IDataSource ds) 

II getDataDestinations 

public Vector getDataDestinations ( ) 

$1 getDataEventListener 

public IDataEventListener getDataEventListener (String id) 

Return a destination contained by Data Worker whose id matches the string past in as a parm 

• getDataEventListeners 

public Enumeration getDataEventListeners ( ) 

Return a vector of all current Destinations contained by Data Worker 

• getDTD 

public DTD getDTD () 

return a DTD describing the XML that can be retreived using the XML Stream. Note: Not Implemented yet; just returns null. 
9 getFormatter 

public DataFormatter getFormatter { ) 

S tg Get 

fjjji getXSLDocCount 

H|?ublic int getXSLDocCount ( } 

4* return the number of XSL docs that have been assigned 

gjd getXSLDocument 

3* public org. w3c.dom. Document getXSLDocument (String name) 
return the XSLDocument assoc with this name. Null if none exists. 

ft? 

flM getXSLName 

public String getXSLName ( int idx) 

J- Return the Name associated with the given index position (0 based) in the hashtable. Null if not available 

ft moFilter 

public abstract String moFilter (DataEvent evt, Hashtable htParams) 
ft processData 

public abstract void processData (DataEvent evt) 

if removeDataEventListener 

public void removeDataEventListener ( IDataEventListener dd) 

ft setDataDestinations 

public void setDataDestinations (Vector dataDestinations) 
ft setFormatter 

public void setFormatter (DataFormatter formatter) 
tgSet 
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B Class tcs.ain.infoserver. Data Formatter 

public class DataFormatter 

Implements: 

java.io.Serializable 

tcs. persist. TCSPersi stent 

Default implementation just returns the XML data retrieved directly from the data set. 

Operations 

getDataString(l DataSource) 

getSaveablesO 

setSaveables(Object[]) 



• getDataString 

public String getDataString (IDataSource ds) 

Throws: 

I nfoServer Exception 

• getSaveables 

^public Object [] getSaveablesO 

tf) Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
St will come back in the same order when setSaveabies is called. 

si 

Ijfl setSaveabies 

public void setSaveabies (Object [] oa) 

Ul receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
111 handle Null values in the array. 

JjfB Class tcs.ain.infoserver. DataSourceTextDataFormatter 

fljpublic class DataSourceTextDataFormatter 
Cfextends: 

Cf tcs.ain.infoserver. Data Formatter 

^Implements: 

tcs. persist TCSPersistent 

This class returns a format using an XSL Document provided by the data source. The data source can offer multiple styles, each of which is 
queried by name. This is assigned the name to be used for retrieving the XSL doc from the data source. 

Constructors 

DataSourceTextDataFormatterO 

Operations 

formatDocument(Node) 

formatNode(Node) 

getDataString(IDataSource) 

getSaveablesO 

setSaveables(Object[]) 



• DataSourceTextDataFormatter 

public DataSourceTextDataFormatter ( ) 
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• formatDocument 

public String formatDocument (Node node) 



ft formatNode 

protected String formatNode {Node node) 
* Format Each individual node 

• getDataString 

public String getDataString (IDataSource ds) 

Obtain the XSL document from the data source having the name assigned here. If found, apply that style when generating the string. If 
not found, return the super.getDataString{..) 

tt getSaveables 

public Object [] getSaveables ( } 

Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 

• setSaveables 

^public void setSaveables (Object [] oa) 

Ji receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
Cj handle Null values in the array. 

UP Class tcs.ain.infoserver. DataSourceXSLDataFormatter 

^public class DataSourceXSLDataFormatter 

Qpxtends: 

tcs.ain. i nf oserver. DataFormatter 

FfThis class returns a format using an XSL Document provided by the data source. The data source can offer multiple styles, each of which is 
Sfjueried by name. This is assigned the name to be used for retrieving the XSL doc from the data source. 

IS^ttributes 

5% xslDocName 

^Constructors 

DataSourceXSLDataFormatterO 

Operations 

getDataString(IDataSource) 
getSaveablesO 

getTranslatedDocument(lDataSource) 
getXslDocNameO 
setSaveabies(Object[]) 
setXsl DocNa me(Stri ng) 

H xslDocName 

private String xslDocName = new String ( ) 

The name of the XSL document that we wilt pull from the data source 
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S DataSourceXSLDataFormatter 

public DataSourceXSLDataFormatter ( ) 




• getDataString 

public String getDataString (IDataSource ds} 

Obtain the XSL document from the data source having the name assigned here. If found, apply that style when generating the string. If 
not found, return the super.getDataString(..) 

Throws: 

I nf oServerExcepti on 

® getSaveables 

public Object [] getSaveables ( } 

Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 

• getTranslatedDocument 

Cfmblic Document getTranslatedDocument (IDataSource ds) 

*l Return the XSL translated Document object. Return null if no XSL doc assigned. 

8ll getXsiDocName 

'^public String getXsiDocName ( ) 

W tgGet 

b 9t setSaveables 

public void setSaveables (Object [] oa) 

y 5 receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
*jf handle Null values in the array. 

setXslDocName 

Npublic void setXslDocName (String xslDocName) 
tgSet 

B Class tcs. a in. infoserver. Data TranslationFilter 

public abstract class DataTranslationFilter 

implements: 

tcs.ain.infoserverJDataEventListener 
tcs. ain. infoserver J Data EventSource 
tcs.ain.infoserver.lDataSource 

This class receives DataEvents, queries the original datasource and assembles its Own Data. It then generates a new DataEvent to its 
listeners telling them to query it's own data. 

Operations 

addDataEventListener(IDataEventListener) 

getDTDO 

getXMLStream() 

processData(Data Event) 

removeDataEventListener(IDataEventListener) 
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• add Data Even tListener 

public void addDataE vent Listener (IDataEventListener 1) 

• getDTD 

public DTD getDTD () 

return a DTD describing the XML that can be retreived using the XML Stream. 

m getXMLStream 

public InputStream getXMLStream (} 

Return an input stream by which an XML document can be read. We return an INputStream rather than just a DOM XML document 
because: - some data may be too large to process as a single unit - this way multiple XML parsing techniques (SAX, DOM, etc) can be 
used at the discretion of the client. The XML Stream does NOT included DTD info. 

9t processData 

public void processData (DataEvent evt) 

• removeDataEventListener 

public void removeDataEventListener (IDataEventListener 1) 



tfS Class tcs.ain. infoserver. Data Worker 

-Jjpublic class DataWorker 
fjpctends: 

V* tcs.ain. infoserver. Worker 
hjmplements: 

m tcs . a i n . i nf oserver. I D ata EventSou rce 

$ A DataWorker tells a DataDestination that it ought to query a Datasource. 

^Attributes 

n| dataDestinations 
^ dataSources 
3?! owner 

yponstructors 

DataWorkerO 

Operations 

addDataEventListener(IDataEventListener) 

addDataSource(IDataSource) 

doWork() 

getDataDestinationsO 
getDataEventListener(String) 

getDataEventListenersQ 

getDataSource(int) 

getDataSources() 

getOwner() 

getSaveables() 

moLaunch(Hashtabie) 

removeDataEventListener(IDataEventListener) 

removeDataSource(IDataSource) 

setData Desti nations(Vector) 

setDataSources(Vector) 

setOwner(Object) 

setSaveables(Object[]) 

stopQ 



Page 97 of 332 



ft dataDestinations 

private Vector dataDestinations 

Associates: 

IDataEventListener 

• dataSources 

private Vector dataSources 

Associates: 

IDataSource 

ft owner 

private Object owner 
owner of dataworker 



• DataWorker 

I^publ ic DataWorker ( ) 



HI 



Jft addDataEventListener 

^public void addDataEventListener (IDataEventListener dd) 

■fft addDataSource 

public void addDataSource ( IDataSource ds) 

iJjft doWork 

tljbublic void doWorkO 

Required method for a worker. Called whenever the timer decides it's time for me to act. Here I generate a new DataEvent and pass to 
H each DataDestination object for each DataSource 

ft getDataDestinations 

public Vector getDataDestinations ( ) 

ft getDataEventListener 

public IDataEventListener getDataEventListener (String id) 

Return a destination contained by Data Worker whose id matches the string past in as a parm 

ft getDataEventListeners 

public Enumeration getDataEventListeners ( ) 

Return an enum of all current Destinations contained by Data Worker 

ft getDataSource 

public QueryEngine getDataSource ( int index) 

Return a QueryEngine element located at the specified index of the dataSources Vector 

ft getDataSources 

public Vector getDataSources ( ) 
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• getOwner 

public Object getOwner () 

• getSaveables 

public Object [3 getSaveables ( } 

Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 

• moLaunch 

public String moLaunch (Hashtable htParams) 

Required method for a worker. Launch a DataWorker on demand 

ft removeDataEventListener 

public void removeDataEventListener (IDataEvent Listener dd) 
ft removeDataSource 

public void removeDataSource ( IDataSource ds) 

ft setDataDestinations 

public void setDataDestinations (Vector dataDestinations) 

^fl setDataSources 

%|>ublic void setDataSources (Vector dataSources) 

III / 
llfl setOwner 

JJjpublic void setOwner (Object owner) 

fljpl setSaveables 

£ public void setSaveables (Object [] oa) 

M receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
I'll handle Null values in the array. 

I 'it 

pH stop 

|IIjbublic void stopO 

Required method for a worker. Called whenever the timer decides it's time for me to act. Here I generate a new DataEvent and pass to 
each DataDestination object for each DataSource 

H Class tcs.ain.infoserver.ElementNotFoundException 

public class ElementNotFoundException 
Extends: 

tcs.ain.infoserver.lnfoServerException 

Constructors 

ElementNotFoundException(String) 

ft ElementNotFoundException 

public ElementNotFoundException (String s) 
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B Class tcs.ain/mfoserver. Email UserDestination 

public class EmailUserDestination 
Extends: 

tcs.ain.infoserver.UserDeliveryDestinatton 
Send the output to a user's email account. SMTP-relevant info must first be defined for the class. 



Attributes 

DefaultSmtpHost 

DefauitSmtpPort 

msgDest 

smtpHost 

smtpPort 

Operations 

cleanUpO 

getDefaultSmtpHost() 

getDefaultSmtpPort() 

getMsgDest() 

getSaveables() 

getSmtpHostO 

getSmtpPort() 

onWorkerErr or(Data Worker, String) 

processData(DataEvent) 

setDefaultSmtpHost(String) 
Q setDefaultSmtpPort(int) 
,fl setMsgDest(String) 

setSaveabies(Object[]) 
^ setSmtpHost(String) 
HI setSmtpPort(int) 

III 



iff 



W 

pjSI DefaultSmtpHost 

s private static String DefaultSmtpHost 



fljl DefauitSmtpPort 

flprivate static int DefauitSmtpPort 
CJJI msgDest 

^private String msgDest 
H smtpHost 

private String smtpHost 

9t smtpPort 

private int smtpPort 



• cleanUp 

public void cleanup {) 
Clean up 

• getDefaultSmtpHost 

public String getDef aultSmtpHost { ) 

tgGet 
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ft getDefaultSmtpPort 

public int getDef aultSmtpPort ( ) 

tgGet 

• getMsgDest 

public String getMsgDest {} 
tgGet 

• getSaveables 

public Object [] getSaveables 0 

Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called, 

• getSmtpHost 

public String getSmtpHost ( } 
tgGet 

• getSmtpPort 

^public int getSmtpPort ( } 
II tgGet 

Qp- onWorkerError 

!!|>rotected void onWorkerError (Da taWorker worker, String errorMsg) 

~% Stop DataWorker, save error message to log, save worker to agent, and save agent to database 

processData 

I.j>ublic void processData (DataEvent evt) 
m i have new data; Send the data string to the screen 
ril Throws: 

Q EmailUserDestinationException 
bH setDefaultSmtpHost 

public void setDefaultSmtpHost (String Def aultSmtpHost) 
tgSet 

ft setDefaultSmtpPort 

public void setDef aultSmtpPort ( int Def aultSmtpPort ) 
tgSet 

• setMsgDest 

public void setMsgDest (String msgDest) 
tgSet 

ft setSaveables 

public void setSaveables (Obj ect [] oa) 

receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
handle Null values in the array. 
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$ setSmtpHost 

public void setSmtpHost {String smtpHost) 
tgSet 

ft setSmtpPort 

public void setSmtpPort {int smtpPort) 
tgSet 



B Class tcs.ainJnfoseiver. EmailUserDestinationException 

public class EmailUserDestinationException 
Extends: 

tcs.ain. inf oserver. I nf oServerException 



Constructors 

EmailUserDestinationException(String) 



■■■■■■■■■ 



»P EmailUserDestinationException 

public EmailUserDestinationException (String s) 



fiP Class tcs.ain. inf oserver. InfoServer 

^public class InfoServer 
■i fextends: 

Pi java.lang.Thread 

T t Version information 1.0.0 

\}$i\ttributes 

access 
CI logger 

r| MaintenanceVersion 
T* MajorVersion 
^ MindrVersion 
repository 

Constructors 

lnfoServer() 

Operations 

getRepository() 
logMsg(int, String) 
main(String|]) 
run() 

ft access 

protected Inf oServerAccess access 
ft logger 

private static Logger logger 

• MaintenanceVersion 



Wmm 
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static int MaintenanceVersion = 0 

• MajorVersion 

static int MajorVersion = 1 

• MinorVersion 

static int MinorVersion = 0 

• repository 

protected static Repository repository 



ructor Detail 



• InfoServer 

public InfoServer (} 

This creates a repository and loads/runs all userAgents within that repository. 

Throws: 

InfoServerException 

RemoteException 

Exception 

getRepository 

public static Repository getRepository { ) 

y* iogMsg 

^public static void logMsg(int level, String content) 

Jfl main 

m 

p public static void main (String [] args) 
P| Create the InfoServer and tell it to load/start all user agents 

l^JI run 

public void run() 

Token runQ method to keep app running o we can add agents, etc. 



H Class tcs.ain. infoserver. InfoServerElement 

public class InfoServerElement 

Implements: 

javaJo.Serializable 

tcs. persist. TCSPersistent 

Base class for al! InfoServer elements. Provides mechanism for grouping, ensures all elements are seriaiizable, provides common 
description functions, etc. 

Attributes 

description 
id 

iogMsg 

Operations 

getDescription() 
getfdQ 
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getLogMsg() 

getSaveables() 

loglnfo(String) 

setDescription(String) 

setld(String) 

setLogMsg(String) 

setSaveabies(Object[]) 




• description 

private String description 

©id 

private String id 

Unique identifier for the object 

• logMsg 

private String logMsg 
Stores the last log message 




f p getDescription 

>ublic String getDescription ( ) 
f: tgGet 

^"public String getld{) 

11 

IP getLogMsg 

public String getLogMsg () 

ft getSaveables 

public Object [] getSaveables ( ) 

Return an array of a!! objects that should be persistent primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 

• loglnfo 

public void loglnfo (String msg) 

Common mechanism for logging information within the server. 

• setDescription 

public void setDescription (String description) 
tgSet 

• setld 

public void setld (String id) 
tgSet 
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• setLogMsg 

public void setLogMsg {String msg) 
tgSet 

• setSaveables 

public void setSaveables (Object [] oa) 

receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
handle Null values in the array. 



H Class tcs. ain.infoserver. I nfoServer Event 

public class Inf oServerEvent 

Extends: 

java . u ti I . Even tObj ect 

Top level event type for events with the Info Server. 
Constructors 



I nf oServerEvent(Object) 



IP InfoServerEvent 

^public InfoServerEvent (Object o) 



|;H Class tcs.ain. infoserver. InfoServerExceotion 

yjpublic class Inf oServerException 
^Extends: 

'l^i java.lang.Exception 



ft! 



"Constructors 



I nf oServerExcept ion(Stri ng) 



• InfoServerException 

public Inf oServerExcep t ion (String s) 



H Class tcs.ain. infoserver JDBCOuervEngine 

public class JDBCQueryEngine 

Extends: 

tcs.ain. infoserver.QueryEngine 

A QueryEngine that accesses a JDBC data source. This model copies the ENTIRE data into memory. Other implementations can stream if 
necessary. This also assumes a SINGLE database query is performed (although that query can be reassigned). 



Attributes 

ba 

ciassName 
connection 
dtd 

password 
queryStr 
ROW 
ROWSET 
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TYPE 

userName 

VALUE 

Constructors 

JDBCQueryEngine() 

JDBCQueryEngtneCString, String, String, String) 

Operations 

generateData() 

generateDTD(ResultSetMetaData, TXDocument) 
getClassNameO 

getDTDO 
getPasswordO 

getQueryStrO 

getSaveablesO 

getUserNameO 

getXMLStreamO 

makeConnectionO 

requery() 

setQueryStr(String) 
setSaveables(Object[]) 




Mjprotected ByteArrayOutputStream ba 

^5 This contains data that can be returned in the InputStream. 

£11 transient 



SM className 

^protected String className 

the JDBC clas file name used to create the connection. 



connection 

^protected Connection connection 
M transient 

I" s 

h» dtd 

protected DTD dtd = null 

The DTD that describes my data. Obtained through getDTD method 
transient 



• password 

protected String password 



W: queryStr 

protected String queryStr 

The SQL query that is to be performed 



• ROW 

public static final String ROW = "row" 



m ROWSET 

public static final String ROWSET = "results 
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• TYPE 

public static final String TYPE = "type" 

• userName 

protected String userName 
m VALUE 

public static final String VALUE = "value" 



pr Detail 



9: JDBCQueryEngine 

public JDBCQueryEngine { ) 



9 JDBCQueryEngine 

public JDBCQueryEngine (String classname, String username, String password, String queryStr) 



5*1* generateData 

^protected void generateData ( ) 

fee? 

hi Generate a temporary DOM structure to hold the data and write it's content into the bytearraystream. 

Ill 

n$& generateDTD 

Jprivate DTD generateDTD {ResultSetMetaData md, TXDocument doc) 
W Generate the DTD from for database 
^ Throws: 

^ java.sqLSQLException 

y|l getClassName 

j^jpublic String getClassName ( ) 

Q tgGet 
m getDTD 

public DTD getDTD () 

return the DTD for my data. Nul! if the underlying data is not available. 

• getPassword 

public String getPassword ( ) 
tgGet 

• getQueryStr 

public String getQueryStr ( } 
tgGet 

getSaveables 

public Object [ ] getSaveables { ) 

Return an array of all objects that should be persistent primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 
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•f getUserName 

public String getUserName ( ) 
tgGet 

m getXMLStream 

public InputStream getXMLStream { ) 
return an XML stream for my data 

• makeConnection 

protected void makeConnection ( ) 

Make the jdbc connection. Catch any errors internally and log. 

H requery 

protected void requery () 

Refresh the view of the external data source. By default, if the requery() call is made in an interval < the querylnterval from the 
lastCheckDate, then nothing will happen. 

■f setQueryStr 

public void setQueryStr (String q) 



it tgSet 



setSaveables 

P|>ublic void setSaveables (Object [] oa) 



receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
# handle Null values in the array. 



!"B C\^s tcs.ainjnfoserverJDBCOuervEnRine.XMLInputStream 

Qclass XMLInputStream 
Jjfextends: 

IU java.io.lnputStream 

SfThis handles access to the XML data through an input stream. Each object to request the inputstream gets one of these, which handles 
Spending the data to the client from the bytearray data. Can be used by children at their discretion (e.g., if spooling cached data) 



Attributes 

lastPos 

Operations 

read() 



lilliij 



• lastPos 

int lastPos 



-1 



• read 

public int readO 

Throws: 

lOException 
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B Class tcs.ain.infoserver.NewEmailOEException 

public class NewEmailQEException 
Extends: 

tcs . ai n . i nf oserver. I nf oServerException 

Constructors 

NewEmailQEException(String) 




• NewEmailQEException 

public NewEmailQEException {String s) 



c: 



B Class tcs.ain.infoserver.NewEmailOueryEngine 

public class NewEmailQuery Engine 

Extends: 

tcs.ain.infoserver.QueryEngine 

This class publishes new Email messages that appear in a maiibox for a user at an IMAP address. This Email information must be provided 
in the constructor of the class and/or via accessors. It is also possible to this class also act like a data worker. If could register as a Folder 
ystener and immediately fire events whenever this is notified of new mail. Unfortunately, this would create a lock on the InBox and 
jotentialiy tie up network resources. This just acts like a listener and only requeries whne asked, provided that the minQuerylnterval has not 
llieen exceeded. It opens an IMAP connection as READONLY, checks for NEW messages, and closes when done. Because of the potential size 
%©f this data, the final implementation should not be cached, but rather stream directly from the IMAP source to the XML Reader !!!!!YOU 
*|i|UST SUPPLY THE host, accountUser, mailBox, AND password VARIABLES BEFORE USEING!!!)!!!!!! 

Attributes 

:~: folder 
HI host 
g mailbox 
^ password 
JfJ properties 
rt| session 
f|J store 
userAcct 

{^Constructors 

H NewEmailQueryEngine() 

Operations 

cioseMessageStore() 
convertToXmi(Message, Document) 
generateData() 
getDTDO 

getFolderlnfoElementCFolder, Document) 

getHost() 

getMailboxO 

getPasswordO 

getSaveablesO 

getUserAcctQ 

getXmiElement(String f String, Document) 

getXMLStreamO 

openMessageStoreO 

requeryQ 

setHost(String) 

setMailbox(String) 

setPassword(String) 

setSaveables(Object[]) 

setUserAcct(String) 
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mba 

protected By teArrayOutput Stream ba 

This contains data that can be returned in the InputStream. 
transient 

Wt folder 

protected Folder folder = null 
transient 

• host 

private String host 

ft mailbox 

private String mailbox 

• password 

private String password 

'|fl properties 

protected Properties properties = null 
transient 

III 

rft session 

protected Session session = null 
^ transient 

[Mi store 

protected Store store = null 
CI transient 

• userAcct 

private String userAcct 



51 NewEmailQueryEngine 

public NewEmailQueryEngine ( ) 

Construct with all the info reqd to access a mailbox 

Operation Detail 

• closeMessageStore 

protected void closeMessageStore { ) 

Close the message store. Called from generateData() after the data has been queried 

Throws: 

MessagingException 



